home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / internet / cswsk110 / readme.txt < prev    next >
Text File  |  1995-12-07  |  10KB  |  212 lines
  1.                         SocketWrench/VB Custom Control
  2.                                  Version 1.1
  3.  
  4. Welcome
  5.  
  6. Please read this document carefully; it contains information about installing
  7. and using the SocketWrench/VB Windows Sockets custom control. Before you
  8. install the control, please be sure that your system has the following products
  9. installed (the version number indicates the earliest release that is supported;
  10. a later release may also be used):
  11.  
  12.     Microsoft Windows 3.1 or Windows for Workgroups 3.11
  13.     Visual Basic 3.0
  14.     Windows Sockets 1.1 Library
  15.  
  16. If you have any questions about which version of the above products are
  17. installed, check the software documentation or contact your network or 
  18. systems administrator.
  19.  
  20. Catalyst Software
  21.  
  22. SocketWrench/VB is part of a package developed by Catalyst Software called
  23. SocketTools. In addition to the comprehensive, but fairly low-level, access
  24. that SocketWrench/VB provides, the package includes custom controls for
  25. many of the popular TCP/IP and Internet application protocols. SocketTools
  26. includes components such as DNS, FTP, TELNET, SMTP, POP3, NNTP, PING, RLIB,
  27. HTTP and HTML. SocketTools will include all custom controls in the form of a
  28. VBX, 16-bit OCX and 32-bit OCX for use with Visual Basic 3.0, Visual Basic 4.0
  29. (16-bit edition) and Visual Basic 4.0 (32-bit edition). Each custom control
  30. hosts a large number of properties and events that, when using defaults,
  31. provide simplicity and efficiency, and yet, offers great flexibility and
  32. power.  This important component of a useful developer's tool is evidenced
  33. in SocketWrench/VB and is carried over into the SocketTools suite.
  34.  
  35. The most exciting component in SocketTools is our World Wide Web browser
  36. custom control. The control offers the best of both worlds: a powerful browser
  37. with complete rendering capabilities that can be easily customized to meet
  38. the needs of your application. Although the Web control offers many options
  39. in the form of properties, methods and events, you can create your own custom
  40. browser by simply selecting the control, creating a text and button control
  41. and setting the resource property. And when integrated with our other
  42. controls, you can build a fully-featured, Internet-enabled application in
  43. just minutes! 
  44.  
  45. More details regarding SocketTools is outlined in the file CSTOOLS.TXT (or
  46. CSTOOLS.WRI for you WRITE fans) included with this product.
  47.  
  48. Catalyst Software is committed to providing the tools and component software
  49. that help developers meet the increasingly complex needs of their customers.
  50. Please read on to obtain information about a special offer when you register
  51. SocketWrench/VB.  For more information, please contact our business and sales
  52. office listed below.
  53.  
  54. Free Distribution
  55.  
  56. SocketWrench/VB is freely re-distributable software. You may use the control
  57. in your own applications and redistribute the package as needed. However,
  58. SocketWrench/VB has not been placed in the public domain. Catalyst Software
  59. retains the copyright and may, without prior notice, release subsequent
  60. versions of SocketWrench/VB that are not freely re-distributable. As a
  61. developer, you may include the control in your applications as per the
  62. license agreement included with this software distribution.
  63.  
  64. If you have found SocketWrench/VB to be useful, please consider registering
  65. the software by completing the form in the register.txt file. Please include
  66. your full name, address, daytime voice and fax number, and your email address
  67. if available.
  68.  
  69. There is no charge or obligation when registering SocketWrench/VB, and you
  70. will receive a $50.00 discount towards the purchase of SocketTools. To reach
  71. Catalyst Software Business and Sales office, contact us at:
  72.  
  73.         Catalyst Software
  74.         56925 Yucca Trail
  75.         Suite 254
  76.         Yucca Valley, California 92284
  77.  
  78.         Phone:  (619) 228-9653
  79.         Fax:    (619) 369-1185
  80.         Email:  sales@catsoft.com
  81.  
  82. To reach Catalyst Software Technical Support office, contact us at:
  83.  
  84.         Catalyst Software
  85.         638 Lindero Canyon Road
  86.         Suite 107
  87.         Oak Park, California  91301
  88.  
  89.         Phone:  (818) 879-1144
  90.         Fax:    (818) 879-1211
  91.         Email:  support@catsoft.com
  92.  
  93. You can receive all of the up-to-the-minute information about Catalyst
  94. Software and our products by visiting our Web site at:
  95.  
  96.     http://www.earthlink.net/~catalyst/
  97.  
  98.  
  99. Documentation
  100.  
  101. The documentation for this control is provided both as a Windows help file
  102. and as a Microsoft Word 6.0 document. Although the document is copyrighted,
  103. it may be freely copied and redistributed throughout your organization as
  104. needed.
  105.  
  106. Installation
  107.  
  108. To install SocketWrench/VB, run the installation utility that is included with
  109. the package. If the package was downloaded from a bulletin board system, it
  110. will be necessary to extract the files from an archive. To install the
  111. software, select File..Run from the Program Manager menu. A dialog box will
  112. prompt you for the name of the program to execute. If you are installing from
  113. a diskette, enter a:\setup. Otherwise, specify the complete path where the
  114. setup utility is located.
  115.  
  116. When the installation begins, you will be prompted to enter the name of a
  117. directory where documents and sample programs can be installed. If the
  118. directory does not exist, you can choose to have the setup utility create
  119. it for you. This distribution contains the following files: 
  120.  
  121.     cswsock.vbx    SocketWrench/VB custom control
  122.     cswsock.hlp    Help file for the custom control
  123.     cswsock.bas    Visual Basic module to include in projects
  124.     cswsock.doc    SocketWrench/VB control documentation (Word 6.0 format)
  125.     tcpintro.doc    Introduction to programming with SocketWrench/VB
  126.     compat.wri    Control compatibility notes
  127.     license.wri    Software license agreement
  128.     generic.*    Visual Basic project for a sample application
  129.     tcpecho.*    Visual Basic project for a TCP test utility
  130.     udpecho.*    Visual Basic project for a UDP test utility
  131.     tinyftp.*    Visual Basic project for a simple FTP client
  132.         telnet.*        Visual Basic project for a Telnet client
  133.  
  134. The SocketWrench/VB control and help file will be copied to the \WINDOWS\SYSTEM
  135. directory along with the other Visual Basic controls. After all of the files
  136. have been installed, you will be prompted if you wish to create a program
  137. group for the help and documentation files.
  138.  
  139. Once the installation is completed, you can add the control to your project
  140. from within Visual Basic by selecting File..Add File from the menu. Select
  141. the cswsock.vbx file from the file list, and you should see the control added
  142. to your toolbox. It is suggested that you also include the cswsock.bas module
  143. in your project as well. It defines global constants that are commonly used
  144. when programming the control.
  145.  
  146. Windows Sockets Loopback Library
  147.  
  148. For those systems that are not connected to a network, or do not have
  149. a Windows Sockets library, a stub "loopback" library has been included
  150. with this distribution of SocketWrench/VB. This library allows SocketWrench/VB
  151. to function as though a network connection exists, which in turn allows
  152. you to develop applications with SocketWrench/VB. This library should only
  153. be installed and configured by someone who is familiar with TCP/IP. It
  154. should never be installed on a system which already has another TCP/IP
  155. protocol stack installed.
  156.  
  157. If no Windows Sockets library is found on your system when SocketWrench/VB
  158. is installed, you are given the option to install the loopback library.
  159. If you do install the library, it will be copied to the installation
  160. directory as WINSOCK.DLL. In order for the SocketWrench/VB control to find
  161. the library, you must either include the installation directory in your
  162. PATH environment variable, or copy it to the \WINDOWS directory. If you
  163. do copy the library to the \WINDOWS directory, you must also copy the
  164. WINSOCK.INI file there as well. This file contains configuration data
  165. used by the library, and has two sections which look something like this:
  166.  
  167. [Host]
  168. Address=192.0.0.1
  169. Name=myhost
  170. Domain=mydomain.com
  171.  
  172. [Files]
  173. Hosts=c:\catalyst\winsock\hosts
  174. Protocols=c:\catalyst\winsock\protocol
  175. Services=c:\catalyst\winsock\services
  176.  
  177. The first section, "Host", describes the local system. The "Address"
  178. item specifies the IP address that is to be associated with the local
  179. host, "Name" specifies the name of the host, and "Domain" specifies
  180. the host's domain.
  181.  
  182. The second section, "Files", specifies the location of the text databases
  183. which are used by the loopback library. If the values are incorrect
  184. (such as if they specify non-existant files), the function calls associated
  185. with the item will fail. This means that if, for example, the protocol
  186. file does not exist, any function which attempts to resolve a protocol name
  187. will fail with an error.
  188.  
  189. Reporting Problems
  190.  
  191. If you encounter a problem, either with the control itself, or with the
  192. documentation, please document the error and send an e-mail message to either
  193. of these addresses:
  194.  
  195.     CompuServe:    72202,1427
  196.     Internet:    support@catsoft.com
  197.  
  198. Please be as specific as you can about the problem that you're experiencing.
  199. When reporting the problem, please be sure to include the following
  200. information in your message:
  201.  
  202.     Operating system and version
  203.     Physical connection (Ethernet, dialup SLIP/PPP, etc.)
  204.     TCP/IP vendor and version information
  205.  
  206. Known problems with a specific vendor's Windows Sockets implementation can
  207. be found in the Compatibility Notes document distributed with this product.
  208.  
  209. Copyright 1995, Catalyst Software. All rights reserved.
  210. SocketWrench/VB is a trademark of Catalyst Software.
  211. Windows and Visual Basic is a trademark of Microsoft Corporation
  212.